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PREFACE 


This document contains three sections as follows: 


SectionI : Contents of the System Disk 
Section II : Notices and Temporary Restrictions 
Section III : Modifications to Operating System Documentation 
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SECTION I 


CONTENTS OF THE 
SYSTEM DISK 


All the UNIX SYSTEM V RUNTIME standard files are provided in the 
system disk with the addition of the following: 


backup mustrun 
conlog pkprint 
diskinit savrest 
dupvol selrestore 
easyconf selsave 
easylife star 
hrestore stl 
hsave tapereel 
ibmread termconf 
ibmwrite upsstat 
INAT whatis 
IXS 
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System Disk 


SECTION II 


NOTICES AND TEMPORARY 
RESTRICTIONS 


NOTE: The following bootstrap diskettes are supplied with the system: 
DKT *BOOTI1’ 
DKT ‘COMMANDS’ 
DKT *BOOTI-INSTALL’ 
DKT *BOOT2’ 
The DKT ’BOOTI’ diskette contains: 


kernel 
bootstrap 


The DKT ’COMMANDS’ diskette allows the following commands to 


be used: 
cat inittab rn 
checktail in savrest 
cp Is sh 
cpio mkdir su 
diskinit mkfs sync 
echo mknod tailoring 
hrestore mnttab umount 
installunix mount 
init | passwd 
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The DKT ’BOOTI-INSTALL’ diskette contains: 


kernel 
bootstrap 


The DRT ’BOOTZ2’ diskette allows a disk/slice to be saved/restored 
on/from cartridge. 


WARNING 


This procedure is valid just in the case the 
streamer unit is connected to the DCS board 

If the streamer is connected to the DCE board, 
use the command savrest contained in the 
COMMANDS diskette. 
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BSC 2780/3780 


Connection with the DOS 


The 2780 configurator file, /usr/lib/bscbatch/2780, containing the physical 
and logical characteristics of the transfer, must be configured using the vi 
command. Here is an example: 


DEVICE=/dev/bscx 

DUPLEX=HALF/FULL 
SIGNON=/usr/spool/bscbatch/2780/signon 
BLKSIZE=400 

RECSIZE=80 

RECBLK=NO 

COMP RESS=NO 


where x is the specific device. 


Connection with DPS4 


The dps4 configurator file, /usr/lib/bscbatch/dps4, containing the physical 
and logical characteristics of the transfer, must be configured using the vi 
command. Here is an example: 


DEVICE=/dev/bscx 
DUPLEX#HALF/FULL 
BLKSIZE=400 
RECSIZE=80 
RECBLK=NO 


where x is the specific device. 
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Connection with DPS6 


The following patch. W9119ART, is required to run BSC 2780 to the 
DPS6 on the MOD400 Release 3.1 Operating System: 


EP W9119ART 
SP W9119ARRT 
/1A02; (2D3F,030D;B 2AB6) 
/2AB6; (CCC7;CMV $R2,19) 
BE 1A44 
DC 2D3F 

BG 1A10 
B 1A0F 
/1AAD; (2D3F,302;B 2AC2) 
/2A08; (CCC7;CMV $R2,19) 
BE 1AB2 
DC 2D3F 
BG 1AB0 
B 1AAF 


The dps6 configurator file, /usr/lib/bscbatch/dps6, containing the physical 
and logical characteristics of the transfer, must be configured using the vi 
command. Here is an example: 


DEVICE=/dev/bscx 
DUPLEXHALF/FULL 
RECSEP#EM 
BLKSIZE=400 
UNITSEP#YES 
RECSIZE=80 
RECBLK=2 

COMP RESS=#NO 
TIMEOUT=10 


where x is the specific device. 


Before performing the file transfer using vi, enter three times the 
combination of CTRL V followed by ESC 4, at the head of each file to be 
transferred. At the tail of each file enter two oblique strokes, //. 
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ya, 
Connection with DPS8 


The dps8 configurator file, /usr/lib/bscbatch/dps8, containing the physical 
and logical characteristics of the file transfer, must be configured using the vi 
command. Here is an example: 


DEVICE=/dev/bscx 
DUPLEX#HALF/FULL 
RECSEP#=EM 
BLKSIZE=400 
UNITSEP=YES 
RECSIZE=80 
RECBLK=4 

COMP RESS=#NO 


where x is the specific device. 


The following initial statements must be included at the head of each file 
to be transferred: 


$*SCNR RBF,XXXX,AZZ:I 
$*SRCD 


$ SNUMB KKKKK 
S IDENT SELVyyeery yy , AAAAAA 
$ USERID WWWWWWWW 
$ UTILITY 
$ FUTIL IN,OT, REW/IN, OT/, COPY/1F/, REW/IN, OT/ 
$ PRMFL OT,W,S,directory/filename 
$ DATA IN 

where: 
ZZ is the identifier of the job 
KKKKK is the name of the job 
XXXX is the name of the node 
LS OLDER PSL @ 6 is the user’s private name 

fr» AAAAAA is the name of the your station 
WWWWWWWW is the user's identifier and the password (if 
present). 
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NOTE: The $*$CNR statement must only preceed the first job. 


Each file to be transferred, must end with the following statements: 


$ ENDJOB 
EOF 


If there are several files to be transferred, the last of them, must end with 
the following statements: 


§ ENDJOB 
$*SSTS 
EOF 


Connection with DPS8 DATANET Configured 


Here is an example of configuration for a BSC 2780 line on DNS300 
(DATANET): 


MB 2780 TMG 

TX 2780 TMG -SN 2780 -MB 2780 

SN 2780 TMG -LD 2780 -CD 2780 

LD 2780 TMG -DV 2780 

DV 2780 2780 -MR -NOSDIN -LN 2780 -MD 2780E -TODISC 
6000 -MANLOGO&é -LL 2780 

LL 2780 2780 -T2 80 -SYN X’32’ -NBSYN 3 -RR 10 -RVI 
-SECO -T8 600& -EBCD -PL 2780 

PL 2780 SYN -PHTP 2158 -PHAD X°3800’ -HALF -SWITCH 
3000 -cT CTO06 

CO 2780 TMG -DMB RBF -CD 2780 -SCID HOOS5 

UD 2780 TMG -CD 2780 -LN 2780 

LN 2780 TMG -EXPCN 

CD TMG -CO 2780 
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Two suggestions are: 
1. Remove the $*SDIS card altogether. 


2. Insert the parameter RVIMODE2IGNORE into the host configuration 
file. 


BSC 3270 EMU 


If BSC File Transfer is to be used for the first time, check that the 
configuration screen for the terminal in question exists. If it is not present, it 
must be created; see the EMKEYMAP command in the "BSC 3270 EMU" 
manual. 


Connection with 3270 in Multipoint Mode 


The 3270 configurator file, /usr/lib/bscbatch/3270, containing the physical 
and logical characteristics of the file transfer, must be configured through the vi 
command. Here is an example: 


CODE=#EBCDIC 
DEVICE=/dev/bscxm0-Y 
DUPLEX#HALF/FULL 

MP TADDR#ZZ 


where: 
X is the specific device. 


Y is the specific station number. 
ZZ is the station address. 
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Connection with DPS8/DPS7 DATANET Configured 


Here is an example of the configuration for a BSC 3270 line on DNS200: 


DV HONEYO 3270 -MODEL 3276-2 -PHAD 0 -CL CLIV 

DV HONEY1 3270 -MODEL 3276-2 -PHAD 1 -CL CLIV 

DV HONEY2 3270 -MODEL 3276-2 -PHAD 2 -CL CLIV 

CL CLIV 3270 -PHAD 0 LL LLIV 

LL LLIV 3270 -EBCD -PL BOB1 -T2 80 -T3 90 -T4 3 -TS 
65 -T6 90 -T7 40 

PL BOB1 SYN -PHTP 2158 -PHAD X’chan’ -HALF -DIRECT 
=. Cr02z 


Here is an example of the configuration for a BSC 3270 line on DNS300: 


DEVICE HONEYO 3270 -MD 3276-2 PHAD 0 -CL CLIV 

DEVICE HONEY1 3270 -MD 3276-2 PHAD 1 -CL CLIV 

DEVICE HONEY2 3270 -MD 3276-2 PHAD 2 -CL CLIV 

CL CLIV 3270 -PHAD 0 LL LLIV 

LL LLIV 3270 -EBCD -PL BOB1 -T2 80 -T3 90 -T4 3 -TS 
65 -T6 90 -T7 40 X’32’ -NBSYNC 4 

PL BOB1 SYN -PHTP 2158 -PHAD X’chan’ -HALF -DIRECT 
=—Cr Crv2Z 


C-ISAM 


In C-ISAM 3.00, when isclose is called, the files are not physically closed. 
They are only flagged for closure, i.e. virtually closed. The files are closed 
physically only when the system has reached the maximum number of open 
files it can handle and isopen is called. In this case, isopen physically closed 
one of the virtually closed C-ISAM files. This causes a problem if normal 
UNIX files must then be opened, because the virtually closed C-ISAM files are 
still using descriptors which cannot be used by other UNIX files. It is 
recommended that UNIX files be opened first, leaving C-ISAM files 
management to isopen and isclose functions as above. 
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LEVEL II COBOL/ET Rel. 1.1.5 


Getting Started with Level II Cobol/ET 


Contrary to the explanation provided in the manual, it is necessary to use 
one of the following commands to print a file listing: 


lp filename.LST 


cat filename.LST >/dev/l1p 


In fact, the pr spooler mentioned in the manual is replaced by /p in the 
current release. 


"Installation of FORM-2 or Animator": before going to step 2 in this 
paragraph, point 2 of the paragraph "Installation of LEVEL II COBOL/ET 
run-time" must be executed. 


VS Cobol Supplementary Series Source Convertion Manual 


The manual is only valid for the documentation of the CONVERT3 utility. 
All information regarding UPGRADE 3 must be ignored, as the UPGRADE III 
documentation in the "OPERATING GUIDE" is valid. 


Software Issue Bulletin 
Additional Information: 


Whenever the compiler finds an error. it sounds the terminal bell. To do 
this, the compiler uses the ADIS (ACCEPT/DISPALY) utility to look up the 
bell character in the file /usr/lib/cobol/termdesc. ADIS disable the normal 
UNIX interrupts. If you want to be able to interrupt the compiler, you must 
either use the compiler directive NOBELL to tum off the terminal bell or use 
the compiler directive BELL\"07\" to set the bell character to the hexadecimal 
character expected by your terminal. 
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You can make either of these the system default with the = compiler 
directive, provided this does not conflict with any terminal attached to the 
system. 


Operating Guide 
Page 5.11: 


The key CO33%1 mentioned in the manual, is wrong. It should be 
replaced with C33%1. 


To define the character "!" as an exception key, you would specify: 
C33 %1 


EASYLIFE 


The menu listing contained in the "EASYLIFE USER GUIDE" reflects the 
standard software supplied at the time of this release. The manufacturers 
reserve the nght to change menus as new products are developed. The user will 
find details of new entries in the corresponding manuals. 


When using Easylife on HDS71XX terminals, the Full reverse and Partial 
reverse personalizations may not be selected for the parameters in the masks. 
The parameters must be personalized as No reverse. 


RM/COBOL-85 


It is possible to use mixed visual attributes (e.g., blink+reverse+low) by 
inserting sgr, sgr0 and xmc fields into the terminal's TERMINFO entry. The 
field for each single visual attributes (dim, rev, blink, etc.) must also be 
specified. For more information about constructing one of these entries see the 
documentation about the TERMINFO database. 
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A list of the fields for the VTU004X-VTU005X terminals follows: 


xme=l1, 

smso=\Esi, rmso=\Esr, 
sgr=\Esrs?tp3%t \Esis; $?%p4%t \Esb%; $?%pS%t\Esl%;, 
sgr0=\Esr, 

dim=\Esl, 

blink=\Esb, 

rev=\Esi, 


A list of the fields for the HDS71XX terminals (WYSES0 personalization) 
follows: 


sgr=% (0) $2?Sp3St% (4) S+%; 37% 4SC% (2) +35 S7EPSECS 
{112} $+%e% {48} $+%; \EG%C, 
smc#l, 


A list of the fields for the HDS74XX terminals (VT100 personalization) 
follows: 


sgr=\E[(%?%pl%t; 7%; 8?Rp2ht; 4%; S?27Sp3St; 7%; S2bp4St; 
5%; 8?%p5%t;8%e; 18; 8?7tp6st;133m, 


Using the VTU001X terminal with 24x80 screen, a scroll of the first line 
occures. To solve the problem, set the AUTO LF/CR parameter to OF F in the 
terminal setup. Add the variable am to the terminal’s TERMINFO entry, 
/usr/lib/terminfo/src/honeywell.ti. 


After editing the file, make the modifications active by using the following 
command: 


# tic honeywell.ti 


The first line is no longer scrolled. However, you will lose the last 
character of the first line. 
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WARNING 


These modifications to the terminal’s setup and 
to TERMINFO are only valid for RM/Cobol-85: 
they could cause problems when using other 
packages. 


CONNECTION WITH OTHER SYSTEMS 


For a right dialogue with DPS6 system, DPS6 should have GCOS6 rel.4 
installed. 


HARDWARE 


With the board DCE installed in the system, it is not possible to use the 
third slot of the memory expansion board (MEM3) because of power supply 
problems. 


For the SPI, SP2 and LPO boards, the RINGH INDICATOR functionality 
is supported 


LAN 


In order to execute the appropriate Diag Operating System test. it is 
necessary to install the DIAGLAN diskette in the following way: 


ed / 

mount /dev/fdsk0 /mnt 
ed /mnt/ins 

sh installan 

ed / 

umount /dew/fdsk0 


Oe Whe We A Ae Ae 
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QPERATING SYSTEM 


Commands 


BACKUP (1) 


Files whose pathname contain special character ( $,", 4, & /,\ #, *,!,1,’, 
P, ,, ?) are not supported. 


The backup command uses the /usr/lib/diskbackp file for the incremental 


Save operation. The removal of this file prevents the operation from being 
completed successfully. 


CC(1) 


The -p option is not supported. 


With the disk level VF/20, the C-Compiler does not allow for the 
following type of assignment: 


nargv (i-1] #argv (i++] 
Such assignments must be substituted with the following: 
i++ 
nargv (i-MM=argv [i] 
DIAG: test controlled by Operating System. 
v. VME BUS test 


The HELP command is temporarily not supported. 
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DISKINIT(1M) 


When you have more times the same disk message error of cylinder, head 
and sector, it is necessary to insert in the bad map table, the news bad 
informations. The following relations provides to change the sector number 
show in the error to the B.C.A.I. required to the diskinit. 


If sector is = 0, 
Pilectivns« 27 
else 
B.C.A.I. = Sector Number * (604512) + 27 - 1 


SAG(1G) 


The sag (1G) command -display system activity in a graphical form- is not 
implemented. As a result, the saghdr.h and saga.c & sagb.c files are not 
available. 


SXT(7) 


This script allows the user to automatically create the /dev/sxt directory 
and the relative nodes to the pseudo-device drivers which can be associated to 
each terminal. The input to the script must be the logical board number and the 
terminal line number (see Appendix A in the "System Operations Guide"). 


Notices and Temporary 214 A78140173-701 
Restrictions 


if ($# = 0) 

then 
echo devshl boardnum slotnum [create nodes for shl 

on this tty port] 

exit 1 

5. 

if [! -d /dev/sxt] 

then 
mkdir /dev/sxt 

#4. 

MAJOR=‘expr $1 / 2° 

MAJOR=‘expr SMAJOR + 86° 

BOARD=‘expr $1 % 2° 

Tore. 28 0 4. 2S: eS 67 

do 
echo mknod /dev/sxt/$1$2$i c SMAJOR \ 
‘expr $i+$2 \* 8+SBOARD \* 128° 
mknod /dev/sxt/$1$2$Si c SMAJOR \ 
‘expr $i+S2 \* 8+SBOARD \* 128° 

do 


UUCP (1c) 


Chapter 10 of the "ADMINISTRATOR GUIDE" is titled "UUCP 
Administration”. Pages 10-6 thru 10-8 contain descriptions of the parameters of 
the System File. On pages 10-7 and 10-8 there is a description of the login 
parameter. It is recommended that the user enter only the null string, "”, 
followed by a login name. The null string signifies that no characters are 
initially expected from the remote host. 


In this case, a typical entry in the L.sys file, would resemble th 
following: : 


maria Any tty07 9600 tty07 "" nuucp 


The string nuucp is the login name. Before using any intelligent 
communication device (smart, modem, multiplexer) with cu/uucp, it should be 
set to °8-bits no parity’. Furthermore, the user should not enter extraneous 
characters not supported by the uucp protocol. 
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UUCP NOTES: 
Internal Programs: 


uugetty This program is very similar to the getty program except it 
permits a line (port) to be used in both directions. A 
uugetty will be assigned to a port in the efc/inittab file if 
bidirectional is chosen when you modify a port. uugefty is 
executed as a function of the init program and is described 
in the "ADMINISTRATOR REFERENCE MANUAL". 


AdministrItive File: 


LCK(lock file) Lock files are created in the /usr/spool/locks directory for 
each device in use. Lock files prevent duplicate 
conversations and multiple attempts to use the same 
calling device. The names of Jock files have the format: 


LOCK. .str 


where sér is either a device or computer name. These files 
may remain in the spool directory if the communications 
link is unexpectedly dropped (usually on computer 
crashes). The lock files will be ignored (removed) after the 
parent process is no longer active. The lock file contains 
the process ID of the process that created the lock. 


Making Changes to the /etc/inittab File: 


There are two versions of the Basic Networking Utilities. The differences 
between them are reflected in the /etc/inittab file. The newest version allows for 
bidirectional login capability by respawning uugetty instead of getty. This 
means that if two computers (both using uugefty) were connected via a direct 
link, either of these computers could request communication with the other. 
This would not be true if only one computer was capable of respawning 


uugetty. 
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If the direct link is connecting your system with a computer that has the 
new version of basic networking, the /efc/inittab files on both computers should 
be set up to allow “bidirectional” traffic on the associated lines. This means that 
the lines used must respawn uugefty on each end of the link. This would allow 
either computer to request communication with the other. 


If the direct link is connecting your system with a computer that does not 
have the new version of basic networking, the /etc/inittab file would be set up 
differently on each system. The /efc/inittab file on each computer would be set 
up to allow either “incoming” or “outgoing” traffic on its line. If one computer 
allows incoming traffic, the other must allow only outgoing traffic. A uugetty 
could not be used on either computer in this case. 


VI (1) 

If viis called, and Standard Error has been redirected, the screen will be 
set up incorrectly. 
Errors 

After a floating point trap, it is recommended to shutdown and reiniualize 
the system. 
Library 


Despite returning a value of 1, the TGETENT library does not work 
correctly. 
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Parameters 


NILIST must not be modified. 


ORACLE 


Before executig an ORACLE work session, the user must enter into the 
"SORACLE_HOME/dba/osh.c" file and substitute the instruction 


for (i=l; argv[i] != NULL; nargv[(i-1] = argv(it+]); 
with the following instructions: 


for (il; argv[{i] != NULL; i++); 
nargv({i-1l] = argv({i]; 


Should this not be done, the "osh.c" program will not execute in a correct 
manner. 


SQL/C-SVS 


Compiling embedded SQL/C-SVS Routines 


In order to allow the usage of the SVS-C compiler instead of the AT&T-C 
compiler a macro named CC is provided. It is a filter which convert all the 
parameters given by the user to the cc command into the correspondent 
parameters for the SVS-C compiler (if meaningful) and finally invokes the 
SVS-C compiler. Therefore it is sufficient to replace the cc command with CC 
wherever it occurs in the esq/, cace and cperf shell scripts. 
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# This shell script is a filter to allow the use of the "make" 

# command: 

# = == just write "CC” instead of "cc" and all the parameters will be 
# == recognised and substituted with the correspondent SVS 

# parameters 

5 (when meaningful) 


#process the arguments 
= 
while expr "$#" \> "0" >/dev/null 
do 
case "$1" in 
-B*!-TI-WI-pl-t!-E!-P1!-Si-g) 
echo “$0: the $1 option is not supported by SVS-C" 
nogo=YES 


-D*|-U* 1 -I* ) 
CARGS="$CARGSS1 " 


-L* 1-M1-N1-V1-VS* |-e* 1-1 1-m1-o* | -rl-s|-u* !-x) 
CCFARGS="$CCFARGSS1 " 


-O) 
# Silently ignored 
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-C ) 
nolink=YES 

Pn ) 
FPOINT=-f 

a ) 99 
QUIETNESS=-q 
verbose= YES 


* ) 99 
echo "$0: Unrecognized option ’$1°" 
nogo=YES 
"= ) 
CFILES="$CFILES$1 " 
IFILES="SIFILES$1 " 
CCFARGS="$CCFARGSS1 " 
*4) 
CFILES="$CFILES$1 " 
IFILES="$IFILES$1 " 
CCFARGS="$CCFARGSS1 " 
*.0) 
CCFARGS="$CCFARGSS1 " 


J 
) 
[(CFARGS="$CCFARGSS1 " 
esac 
shift 
done 
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# 
# Was there an error in the argument processing 


+ 
if [ "$nogo” ] 
then 

exit 1 
fi 
# 


# Fix up the file names for the different passes. Done in one lump here 
# to save on multiple invocations of sed. 

# 

CFILES=‘echo "$CFILES" | sed ’sAi /.c /g”* 

IFILES=‘echo "SIFILES" I sed ‘’sAc /.i /g”* 

CCFARGS=‘echo "$CCFARGS" | sed ‘s/A [ci] /.0 /g"* 


# 
# First pass - the preprocessor 
# 
if [ x"$CFILES” != x"" J 
then 
if [ "$verbose" ] 
then , 
echo c $CFILES SCARGS $FPOINT SQUIETNESS -p 
fi 
for f in SCFILES 
do 
if c $f SCARGS $FPOINT SQUIETNESS -p 
then 
else 
nogo=YES 
fi 
done 
6 
if [ “Snogo" ] 
then 
exit 1 
i 
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# 
# Second/third pass - the actual compiler 


# 
if [ x"SIFILES" !=x"" 
then 
if [ “$verbose” ] 
then 
echo jcode SIFILES 
echo jlinker ‘echo "SIFILES" | sed ’sAi / /g”* 
fi 
for fin ‘echo "$IFILES" | sed ’sAji //g”* 
do 
if jcode $f.i && jlinker $f 
then 
else 
nolink=YES 
fi 
done 
rm -f ‘echo "$IFILES" | sed 'sAi /.obj /g”* 
fi 
if { "Snolink” ] 
then 
exit 0 
fi 
# 
# Finally link 
# 
if [ "Sverbose" ] 
then 
echo ccf SCCFARGS -ls -Ip 
fi 


ccf $CCFARGS -ls -Ip 
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TERMINALS 
HDS71XX and HDS74XX 


If Easylife is to be used with HDS71XX and HDS74XX terminals, refer to 
the note concerning Easylife in this chapter. 


HDS74XX - VT200 Personalization 


This type of personalization allows 20 different functions to be invoked: 
unfortunately, the first five are implemented via local function keys, reserved 
for use with the terminal. Consequently there is a difference of five position 
between the function keys and the functions to which they refer. The new 
combinatons of function keys and their relative functions are as follows: 


function key F6 fkl 
function key F7 fk2 
function key F8 fk3 
function key F9 fk4 
function key F10 fk5 
function key F11 fk6 
function key F12 fk7 
function key F13 {k8 
function key F14 fk9 
VTU004X/VTU00SX 


For these terminals, the variable cr has not been defined. To define it, the 
user should add: 


cr=*M 


to the corresponding entries for these terminals in the file 
/usr/lib/terminfo/src/honeywell.ti. Furthermore, to support lines longer than 80 
characters, the user must delete the variable iJ. 
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Enter the following command to execute all the modifications: 


# tic honeywell.ti 


WARNING 


Before executing this command. the user should venfy that 
the system terminfo is being used (the TERMINFO 
variable should have the following value: 
TERMINF O2/usr/lib/terminfo). 


VIPEMU - VIP78XX/VIP77XX 


The VIP77XX terminal emulation is not qualified. 


UNIFY 


When this package is installed, the pathname of the installation directory 
must be specified. If Unify has been installed in /usr/unify/bin, this directory 
must be added to the list of the PATH of the directory in which the system will 
search for the program installed. To do this, you could type: 


PATH=/usr/unify/bin: /bin/usr/bin 
assuming you are using the Boume Shell. Or you could type: 
PATH=: /usr/unify/binSPATH 
where $PATH means to substitute the current value of the variable PATH. 


If the option Rebuild the hash table (rekey) is required, it is recommended 
that it be used only as the first operation of a UNIFY session. If necessary exit 
the current session and re-enter UNIFY before using this option. 
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WH 


During the Rebuilt the hash table operation, the following message may 
be displayed: 


Hash table length is non-prime. System performance can 
. be enhanced by changing the hash table length to a 
prime value. 

Would you like to change the Hash Table length from 
XRKEE tO yyyyy? 


It so. it is recommended to reply n and instead use the Reconfigure Data 
Base (scom) option to make the changes. 


HDS71XX Terminal 


If Unify is used with HDS71XX terminal, the sequences corresponding to 
the cursor positioning and function keys must be entered in the /ib/unicap file 
in the directory in which Unify has been installed. Enter the following 
instructions in the file: 


SECTION = wyse 50 Wyse 50 input sequences 
left _arrow = “H left arrow 

down _arrow = “V down arrow 

right arrow = “L right arrow 

up_arrow = “K up arrow 

£1 = “A@*M age S 

£2 = “AA“M F2 

£3 = “AB“M F3 

£4 = “AC*°M F4 

£5 = “*AD*M rs 

£6 = “AE“M F6 

£7 = “AF*M F7 

£8 = “AG*M F8 

£9 = “AH“M F9 

£10 = “AI*M F10 
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HDS74XX Terminal - VT200 Personalization 


If Unify is used with HDS74XX terminal, the sequences corresponding to 
the cursor positioning and function keys must be entered in the /ib/unicap file 
in the directory in which Unify has been installed. Enter the following 
instructions in the file: 


SECTION = vt200 vt200 input sequences 
left _arrow = \E[D left arrow 
right _arrow = \E[C right arrow 
up_arrow = \E[A up arrow 
down_arrow = \E[(B down arrow 
fl = \E[{17~ F6 

f2 = \E(18~ F7 

£3 = \E(19~ F8 

£4 = \E[(20~ FQ 

£5 = \E(21~ F10 

f6 = \E(23~ Fil 

£7 = \E(24~ F12 

£8 = \E[(25~ Fis 

£9 = \E(26~ F14 


Check that the entry in the /ib/termcap file in the directory in which Unify 
has been installed, is the following: 


d2|vt200|vt-100/pt1l00/pt-100|dec vt100:\ 
>CO#80:1i#24:am:cl=50\E(;H\E(20:bs:cm=5\E([(%is 
2;%2H:nd=\E(C:up=\E([(A: \ 
>ces3\E(K:cd=50\E[(J:is=\E>\E[(?31\E(?41\E[?51\ 
E(?7h\E(?8h\E(1m:\ 
>ws=\E (Om: we=\E[(lm:nm=\E [m\E[1lm:so=\E[7m:se=\ 
E (lm: us=\E(4m:ue=#\E(1lm:\ 
>DE=\177:BR=\003:\ 
>gs™\E (0: gx=\E (B:ga=m:gb=l:gc=k:gd=j:ge=m:gf= 
l:gg=k:gh=j3:\ 
>gi=n:gj=x:gk=q:gl=u:gm=t :gn=w:gorv: 
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SECTION Ii 


MODIFICATIONS TO THE 
OPERATING SYSTEM 
DOCUMENTATION 


UPDATING TO THE PRINTED DOCUMENTATION 


To update the last version of these manuals, remove the old pages and 
insert, in alphabetic order, the new pages. 


User Reference Manual 


Remove Insert 

ibmread(1) ibmread(1) 

ibmwnite(1)/id(1) ibmwnite(1)/id(1) 

ipes(1)/iXS(1) ipes(1)/iXS(1) 

od(1) od(1) 
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Administrator Reference Manual 


Remove Insert 

conlog(1M) conlog(1M) 

mustrun(1M)/mvdir( 1M) | mustrun(1M)/mvdir( 1M) 
runacct(1M)/sadp(1M) runacct(1M)/sadp(1M) 

sxt(7) sxt(7) 
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NAME 


ibmread - copying files from IBM diskette 


SYNOPSIS 


ibmread /dev/name [ -o } [ files... ] 


DESCRIPTION 


This command is used to copy one or more files from an IBM 
floppy to the system disk. 


The copy is performed in the directory in which the user is 

currently working. The copy maintains the same file names 

retest the IBM floppy (upper case format as used in IBM 
iles). 


If the floppy contains files with the same names as_ those 
already present in the system, the copy causes the new files 
to be written over the old files. Therefore, the user is 
advised to create a special directory to which the files 
will be copied. 


The files that can be copied by means of this procedure must 
have the following characteristics: 


they must not multi-volume 
they must not have tree structure 


This command must be run from the directory in which the 
user wants to copy the files. 


The command has the following arguments: 


name is the symbolic identifier of the IBM floppy from 
which the file is to be copied. If the floppy is: 


floppy 9 sectors/track double side name=fdibmd9 
floppy 9 sectors/track single side name=fdibms9 
floppy 8 sectors/track double side name=fdibmd8 
floppy 8 sectors/track single side name=fdibms8 
high density name=fdibmhd 


-o If the files to be copied do not contain source 
programs (e.g., data file, object file), name must 
be followed by the -o option. 


files To specify the names of the files to be copied. The 
name may consist of up to 8 characters followed by a 
full stop and 3 other characters. If no file name 
is specified the entire contents of the floppy are 
copied. 


SEE ALSO 


Ibmread: Copying Files from IBM Diskettes and How to Create 
Nodes for Use of Non-native Diskettes in the System 
Operations Guide. 
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WARNINGS 

Empty files are transferred. | 
If during the copy of object file, the -o option is not WwW 
used, these files not be executable. 


IBMWRITE(1) UNIX System V IBMWRITE( 1) 


NAME 
ibmwrite - copying files from the system to the IBM 
diskettes 
SYNOPSIS 
ibmwrite /dev/name [{ -o ] [ files... ] 
DESCRIPTION 
This command is used to write one or more files from the 
system to the IBM floppy, prior to converting the name from 
lower case to upper case characters as used in IBM files. 
If the floppy conatins a file with the same name of that 
under copy, the copy is interrupted for it and the following 
message appears: 
ibmwr09 file ... is already present! (not replaced) 
The command has the following arguments: 
name Is the symbolic identifier of the IBM floppy .to 
which the file is to be copied. If the diskette is: 
floppy 9 sectors/track double side name=fdibmd9 
floppy 9 sectors/track single side name=fdibms9 
floppy 8 sectors/track double side name=fdibmd8 
floppy 8 sectors/track single name=fdibms8 
high density name=fdibmhd 
-O If the files to be copied do not conatin source 
programs (e.g., data file, onject file), name must 
be followed by the -o option. 
files To specify the names of the files to be copied. The 
name may consist of up to 8 characters followed by a 
full stop and 3 other characters. At least one 
filename must always be present. It is possible to 
specify complete pathnames to specify the names of 
the files (when they are to be copied from different 
directories). 
SEE ALSO 
Ibmwrite: Copying Files from the System to the IBM Diskette 
and How to Create Nodes for Use of Non-native Diskettes in 
the System Operations Guide. 
WARNINGS 


Empty files are transferred. 


If during the copy of object file, the -o option is not 
used, these files will be ruined. 
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NAME 
id - print user and group IDs and names 


SYNOPSIS 
id 


DESCRIPTION 
Id writes a message on the standard output giving the user 


and group IDs and the corresponding names of the invoking 
process. If the effective and real IDs do not match, both 


are printed. 
SEE ALSO 


logname(1). 
getuid(2) in the UNIX System V Programmer Reference Manual. 


we: ee 


IPCS(1) 


rm GROUP (all) 
| CREATOR(a,c) 
CGROUP (a,c) 
CBYTES (a,0o) 
QNUM (a,o) 


QBYTES (a,b) 


LSPID (a,p) 
LRPID (a,p) 
STIME (a,t} 
RTIME (a,t) 
CTIME (a,t) 
NATTCH (a,0) 
cm” SEGSZ (a,b) 
CPID (a,p) 
LPID (a,p) 
ATIME (a,t) 
DTIME (a,t) 
NSEMS' (a,b) 


OTIME (a,t) 


FILES 
/unix 
/dev/kmem 
/etc/passwd 
/etc/group 


SEE ALSO 


UNIX System V IPCS(1) 


The group name of the group of the owner of 
the facility entry. 

The login name of the creator of the 
facility entry. 

The group name of the group of the creator 
of the facility entry. 

The number of bytes in messages currently 
outstanding on the associated message queue. 
The number of messages currently outstanding 
on the associated message queue. 

The maximum number of bytes allowed in 
messages outstanding on the associated 
message queue. 

The process ID of the last process to send a 
message to the associated queue. 

The process ID of the last process to 
receive a message from the associated queue. 
The time the last message was sent to the 
associated queue. 

The time the last message was received from 
the associated queue. 

The time when the associated entry was 
created or changed. 

The number of processes attached to the 
associated shared memory segment. 

The size of the associated shared memory 
segment. 

The process ID of the creator of the’ shared 
memory entry. 

The process ID of the last process to attach 
or detach the shared memory segment. 

The time the last attach was completed to 
the associated shared memory segment. 

The time the last detach was completed on 
the associated shared memory segment. 

The number of semaphores in the set 
associated with the semaphore entry. 
The time the last semaphore operation was 
completed on the set associated with the 
semaphore entry. 


system namelist 
memory 

user names 
group names 


msgop(2), semop(2), shmop(2) in the UNIX System V Programmer 


f > 
BUGS 


Reference Manual. 


Things can change while ipes is running; the picture it 
gives is only a close approximation to reality. 
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NAME 
ixXS, iNAT - Honeywell-Bull "nix machines / Honeywell-Bull 
Uniplus machine diskette compatibility oo 
SYNOPSIS 
ixs 
iNAT 
DESCRIPTION 


Mount format Diskettes 
Mount format diskettes are not compatible because the 
Uniplus and Unix operating systems have different 
characteristics. Therefore, a diskette prepared using 
umount under Uniplus system cannot be restored under Unix 
system, and vice versa. 


Tar or Cpio format Diskettes 
The compatibility of tar or cpio format diskettes depends on 
whether they have been formatted under Uniplus or Unix 
operating system. 


A diskette formatted on the Unix system is not compatible 
with the Uniplus system and may only be used by the Unix 
System. However, a diskette formatted with the 

diskformat -ver /dev/fdformat command on the Uniplus’~ system 


may be: Ned 


written to by Honeywell-Bull Uniplus machine and _ read 
by Honeywell-Bull Uniplus machine 


written to by Honeywell-Bull Unix machine and read by 
Honeywell-Bull Uniplus machine 


written to and read by both Honeywell-Bull Uniplus 
machine and Honeywell-Bull Unix machine. 


To use an Uniplus diskette on the Honeywell-Bull Unix 
system, insert the diskette in the Unix system and enter the 
iXS command. At the prompt signal, the Unix system is set 
up to use diskettes formatted on the Uniplus system. At the 
end, enter the iNAT command. 


In order to once more use diskettes formatted on the 
Honeywell-Bull Unix system, thereby returning to the 
situation prior to the execution of ixS, enter the iNAT 
command. 


SEE ALSO 
1XS/iNAT: Honeywell-Bull Uniplus machines and Honeywell-Bull 
Unix machines diskette compatibility in the System | 
Operations Guide. wy 


a 


OD(1) UNIX System V OD(1) 


NAME 
od - octal dump 
SYNOPSIS 
od (-bcdosxe] [file] [{[{+]joffset[.][b]] [:{x] nblks [.] [b]] 
DESCRIPTION 
Od dumps file, in one or more formats as selected by the 
first argument. If the first argument is missing, -o is 


default. The meanings of the format options are: 

-b Interpret bytes in octal. 

-c Interpret bytes in ASCII. Certain non-graphic 
characters appear as C escapes: null=\0, backspace=\b, 
form=\f, new-line=0 return=\r, tab=\t; others appear as 
3-digit octal numbers. 

-d Interpret words in unsigned decimal. 

~e Trans-codify bytes in EBCDIC. 

-O Interpret words in octal. 

“8 Interpret 16-bit words in signed decimal. 


-Xx Interpret byte in hex. 


The file argument specifies which file is to be dumped. If 
no file argument is specified, the standard input is used. 


The offset argument specifies the offset in the file where 


dumping is to commence. This argument is normally 
interpreted as octal bytes. If is appended, the offset is 
interpreted in decimal. If b is appended, the offset is 


interpreted in block of 512 bytes. If the file argument is 
omitted, the offset argument must be preceded by =. 


The nblks argument specifies the number of blocks to be 
printed out (bytes as default). 


Note that : is the only separator permitted between offset 
and nblks. 


Dumping continues until end-of-file. 


ie a 


CONLOG( 1M) (Not on GCOS4-x) CONLOG( 1M) 


NAME 
conlog - console log 


SYNOPSIS 
conlog [{-e file] [-asu] 
conlog [-d] 


DESCRIPTION 

conlog allows a super-user to enable the logging of all the 
“messages displayed on the system console. Optionally, it is 
possible to request the log of the user messages or the 
kernel messages only. The log file may then be displayed or 
printed. 

This command may be run from any terminal. Therefore, when 
the logging is enabled, it is recommended to use not the 
console but some other terminal to run the view function. 


When conlog is running, it is better to only use the console 
for system administration commands. 


The following options can be applied: 


-e enables the logging; file is the pathname of the file 
to be used as log file. 


-a logs all messages. 

-s logs the kernel messages only. 
-u logs the user messages only. 
-d disable the logging. 


If the command is launched without parameters a menu will be 
displayed. The menu is supposed to be self explanatory. 


SEE ALSO 
Conlog: Console Log in the System Operations Guide. 
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NAME 
mustrun - change processor 

SYNOPSIS 
mustrun filename N 

DESCRIPTION 
This command allows the user to stipulate on which CPU a 
program will be executed. When a program is run, the system 
itself is responsible for delagating its execution to CPU 0 
or CPU 1. Using the mustrun command, the user may address 
execution of a program to a specific CPU. 
The command has two arguments: 
filename is the file with the program to be executed 
N is the number corresponding to the CPU to which 


filename execution is addressed. It may assume 
the following values: ) 


0 execution is addressed to CPU 0 (central 
unit) 

1 execution is addressed to CPU 1 (expansion 
unit) 

a resets previous addressing of a filename to 


CPU 0 or CPU 1, a restores control of 
filename execution to the system. 


The mustrun command is printed by the following commands: 


file 
analyze 
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NAME 
mvdir - move a directory 


SYNOPSIS 
/etc/mvdir dirname name 


DESCRIPTION 
Mvdir moves directories within a file system. Dirname must 
be a directory; name must not exist. Neither name may be a 
sub-set of the other (/x/y cannot be moved to /x/y/z, nor 
vice versa). 


Only super-user can use mvdir. 


SEE ALSO 
mkdir(1). 
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cro BUGS 


Normally it is not a good idea to restart runacct in the 
SETUP state. Run SETUP manually and restart via: 


runacct mmdd WIMPFIX 


If runacct failed in the PROCESS state, remove the last 
ptacct file because it will not be complete. 
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SADP ( 


NAME 


1M) (Not on GCOS4-x) SADP( 1M) 


sadp - disk access profiler 


SYNOPSIS 


sadp [ -th ] [ -d device } s {p34 


DESCRIPTION 


FILES 


Sapd reports disk access location and seek distance, in 
tabular or histogram form. It samples disk activity once 
every second during an interval of s seconds. This is. done 
repeatedly if n is specified. Cylinder usage and disk 
distance are recorded in units of 8 cylinders. 


Valid values of device are st506 (DCS disk controller), esdi 
(DCE or ESD disk controller) and smd (removable disk). 


The -d option may be omitted, if only one device is present. 
The -t flag causes the data to be reported in tabular form. 
The -h flag produces a histogram on the printer of the data. 


Default is -t. 


/dev/kmem 
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<> NAME 


sxt - pseudo-device driver 


DESCRIPTION 

Sxt is a pseudo-device driver that interposes a discipline 
between the standard tty line disciplines and a real device 
driver. The standard disciplines manipulate virtual tty 
structures (channels) declared by the sxt driver. Sxt acts 
as a discipline manipulating a real tty structure declared 
by a real device driver. The sxt driver is currently only 
used by the shl(1) command. 


Virtual ttys are named by i-nodes in the subdirectory 
/dev/sxt, which must be created by the user, and are 
allocated in groups of up to eight. To create a file in 
this directory, use the following command: 


mknod /dev/sxt/bln c Mm 


where: 
b is the board number(*) 
1 is the line number(*) 
n is the channel number, in the range [0-7] 
M is the major number 
Qrr™, m is the minor number 
(*) See Appendix A in the System Operations Guide. 
For the major number, choose the value using the following 
table: 
Board number major 
0-1 86 
2-3 87 
4-5 88 
6-7 89 
8-9 90 
a-b 91 
The minor number is calculated as: 
m=128*(b%2)+8*s 
where b is again the board number and s is the slot number 
on the board. b%2 is the remainder of the b/2 division. 
The file name will be /dev/sxt/bln. 
\ Once each node has been created, link the node which the 


sxtbln driver: 


ln /dev/sxt/bln /dev/sxtbln 
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Only one channel, the controlling channel, can receive input 
from the keyboard at a time; others attempting to read will 
be blocked. 


There are two groups of ioctl(2) commands supported by sxt. 
The first group contains the standard ioctl commands 
described in termio(7), with the addition of the following: 


TIOCEXCL Set exclusive use mode: no further opens are 
permitted until the file has been closed. 


TIOCNXCL Reset exclusive use mode: further opens are once 
again permitted. 


The second group are directives to sxt itself. Some of 
these may only be executed on channel 0. 


SXTIOCLINK 
Allocate a channel group and multiplex the virtual 
ttys onto the real tty. The argument is the 
number of channels to allocate. This command may 
only be executed on channel 0. Possible errors 


include: 

EINVAL The argument is out of range. 

ENOTTY The command was not issued from a real 
tty. 

ENXIO linesw is not configured with sxt. 

EBUSY An SXTIOCLINK command has already been 
issued for this real tty. 

ENOMEM There is no system memory available for 
allocating the virtual tty structures. 

EBADF Channel 0 was not opened before this 
call. 

SXTIOCSWTCH 
Set the controlling channel. Possible errors 
include: 


EINVAL An invalid channel number was given. 


EPERM $$$ The command was not executed from 
channel 0. 


SXTIOCWF Cause a channel to wait until Es is the 
controlling channel. This command will return the 
error, EINVAL, if an invalid channel number is 
given. 
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SXTIOCUBLK 


Turn off the loblk control flag in the virtual tty 
of the indicated channel. The error EINVAL will 
be returned if an invalid number or channel 0 is 
given. 


SXTIOCSTAT 
Get the status (blocked on input or output) of 
each channel and store in the sxtblock structure 
referenced by the argument. The error EFAULT will 
be returned if the structure cannot be written. 
FILES 
/usr/include/sys/sxt.h Driver specific definitions. 


SEE ALSO 
shl(1l), stty(1), iocetl(2), open(2), termio(7). 
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